table of contents
TEE(2) | Руководство программиста Linux | TEE(2) |
ИМЯ¶
tee - повторяет содержимое канала
ОБЗОР¶
#define _GNU_SOURCE /* см. feature_test_macros(7) */ #include <fcntl.h> ssize_t tee(int fd_in, int fd_out, size_t len, unsigned int flags);
ОПИСАНИЕ¶
Вызов tee() повторяет до len байт данных из канала, на который указывает файловый дескриптор fd_in в канал, на который указывает файловый дескриптор fd_out. Он не потребляет данные, копируемые из fd_in, поэтому эти данные можно копировать последующим вызовом splice(2).
Аргумент flags представляет собой набор флагов-модификаторов, которые используются также в splice(2) и vmsplice(2):
- SPLICE_F_MOVE
- В данный момент никак не влияет при указании в tee(); см. splice(2).
- SPLICE_F_NONBLOCK
- Не блокировать ввод-вывод; подробности в splice(2).
- SPLICE_F_MORE
- В данный момент никак не влияет при указании в tee(), но это может измениться; см. splice(2).
- SPLICE_F_GIFT
- Не используется для tee(); см. vmsplice(2).
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
При успешном выполнении, tee() возвращает количество байт, которые были повторены из ввода в выводе. Возвращаемое значение 0 означает, что нет данных для передачи, и блокировка не имеет смысла, так как нет процессов-писателей, подключённых к каналу для записи, на который указывает fd_in.
В случае ошибки tee() возвращает -1, а errno устанавливается в соответствующее значение.
ОШИБКИ¶
ВЕРСИИ¶
Системный вызов tee() впервые появился в Linux 2.6.17; поддержка в glibc добавлена в версии 2.5.
СООТВЕТСТВИЕ СТАНДАРТАМ¶
Данный вызов есть только в Linux.
ЗАМЕЧАНИЯ¶
Концептуально, tee() копирует данные между двумя каналами. В реальности, данные не копируются на самом деле: внутри, tee() назначает данные в вывод просто схватывая ссылку из ввода.
ПРИМЕР¶
В следующем примере реализована простая программа tee(1) с помощью системного вызова tee().
#define _GNU_SOURCE #include <fcntl.h> #include <stdio.h> #include <stdlib.h> #include <unistd.h> #include <errno.h> #include <limits.h> int main(int argc, char *argv[]) {
int fd;
int len, slen;
if (argc != 2) {
fprintf(stderr, "Использование: %s <файл>\n", argv[0]);
exit(EXIT_FAILURE);
}
fd = open(argv[1], O_WRONLY | O_CREAT | O_TRUNC, 0644);
if (fd == -1) {
perror("open");
exit(EXIT_FAILURE);
}
do {
/*
* перекладывать из stdin в stdout.
*/
len = tee(STDIN_FILENO, STDOUT_FILENO,
INT_MAX, SPLICE_F_NONBLOCK);
if (len < 0) {
if (errno == EAGAIN)
continue;
perror("tee");
exit(EXIT_FAILURE);
} else
if (len == 0)
break;
/*
* Поглотить stdin, объединяя данные в файле.
*/
while (len > 0) {
slen = splice(STDIN_FILENO, NULL, fd, NULL,
len, SPLICE_F_MOVE);
if (slen < 0) {
perror("splice");
break;
}
len -= slen;
}
} while (1);
close(fd);
exit(EXIT_SUCCESS); }
СМОТРИТЕ ТАКЖЕ¶
2012-05-04 | Linux |